home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / programming / source / tracker-4.13.lha / tracker / Docs / readmefirst < prev    next >
Encoding:
Text File  |  1995-02-09  |  6.5 KB  |  126 lines
  1. Just a quick question-and-answer file.
  2.  
  3. - What is tracker, what do I need to use it ?
  4. tracker is a generic soundtracker player for unix-like machines. 
  5. You need an amiga or a sparcstation or an siligon graphics iris, 
  6. or a PC with unix and soundblaster, or a DECstation, or an HP700... 
  7. Your machine should be able to produce sounds, that goes without 
  8. saying. You also need tunes to play (mod files). Some are available 
  9. on nic.funet.fi, for instance.
  10.  
  11. You will also want to get zoo and lha for your machines. 
  12. They should be on nic.funet.fi or aminet.
  13.  
  14. - How to compile it ?
  15. The Makefile should be self-explanatory. Mostly you need to set it up
  16. for your machine. The sparc/solaris target depends on which version
  17. of sunos you've got. You will notice if you set it up incorrectly.
  18. Right now, solaris is still a mess, so some hacking around might be needed.
  19. For the amiga and SAS/C, a smakefile is provided.
  20. There are still some obscure problems with NeXt and other machines...
  21. I can't check everything myself, so you might just be on your own in some
  22. cases.
  23.  
  24. - How to use it ?
  25. tracker -help will give you a good idea of what's available.
  26.  
  27. - How does it compare with SparcTracker, or str32 ?
  28. Well it's better... No, actually it's the same program, but the name has
  29. changed as it was evolving.  So anything labelled SparcTracker100, 
  30. SparcTracker1.1, or sparctracker1.2 is OLD.  Don't send me any bug reports
  31. about these older versions, this is useless.  Well, I'll try not to change
  32. the name of the program again...
  33.  
  34. - How does it compare with other trackers on the amiga ?
  35. First, its interface is not very friendly. 
  36. But then, its source is in C, so it's easy to fix what you don't
  37. like, and it should get better over time. Also, it plays entirely by the
  38. rules, so it should work with any foreseeable releases of the OS, or even
  39. with audio cards that patch the audio.device in a reasonable way.
  40. However, there is more to it than meets the eye. The way tracker works is
  41. rather more intricate than most other players, and it should solve most
  42. timing problem in a rather elegant way.
  43.  
  44. - Which kind of modules can it play ?
  45. MOST soundtracker/noiseplayer/protracker modules should play out ok. Due
  46. to various disagreements between all the soundtracker versions (never forget
  47. soundtracker is an horrible HACK, a big KLUDGE), it is a *REAL* nightmare to
  48. try and make some commands work. What you have is my best effort at trying
  49. to outguess every soundtracker composer in existence... Obviously, I haven't
  50. completely succeeded. MED support I've thought of, but don't forget, to
  51. make tracker work, I need to reverse-engineer assembly routines coded like
  52. spaghetti, and transform it into more or less human-readable, normal C code.
  53. So up till now, I haven't had time enough to do the same with MED. Teijo's
  54. code is not exactly limpid, MEDplayer itself tends to change from release to
  55. release. So maybe one day...
  56. Here is what is missing from the protracker format
  57. * extended commands 3/4/7/13/14
  58.  
  59. Actually, if you know other player programs, you will notice that tracker is
  60. better at that compatibility game than most of them, like <BLIP>, <BLOP> or <ZP>
  61. (names intentionnally omitted:-) )
  62.  
  63. - What are these weird things scrolling on my screen ?
  64. These are some informations on the current module, like its name,
  65. the distinct sample lengths and their names. 
  66. Oh, you mean -scroll ? Well, this is the tune being played. Get any protracker
  67. doc, I think you'll understand what's going on.
  68.  
  69. - I can't change the volume of the sound.
  70. That's intentional. There are other programs that do that quite well.
  71. What you really want is an audio control panel. There are some nifty ones
  72. around, just search carefully. There is no real need for tracker to support 
  73. variable
  74. volume.
  75.  
  76. - There are some ``not supported'' messages from time to time.
  77. tracker doesn't support the whole set of protracker commands, so it tells
  78. you when it doesn't play something the way it's supposed to be played.
  79. I don't know if I'll implement the remaining commands, as they are symptomatic
  80. for me that the mod format is just a big kludge, and not getting any better...
  81.  
  82. - I want to use tracker on another machine.
  83. Then you'll have to port it. You can wedge in at two levels: either replace
  84. the audio.c file or the xxx_audio.c. The audio.c works at the amiga level:
  85. it interprets commands to play samples and repeat parts in terms of 
  86. resampling them at the right frequency. If your machine supports four fully
  87. independent channels (like the amiga), you shouldn't have to resample, but
  88. instead issue the proper commands for these samples to play.
  89. Else, you'll have to use resampling, and going through a specialized xxx/audio
  90. file. The examples you have should be quite enough.
  91. If your unix is funky enough, define your machine to use stubs in Unix/ui.c 
  92. at first, then try to get it back into action...
  93. If you make tracker run on another machine, please send me the required changes.
  94. Try to keep it to the audio.c xxx/audio.c and xxx/ui.c file If you make any
  95. other enhancement, I might like to incorporate it in a further release, but
  96. that part of the code may have evolved beyond control in between. xxx/audio
  97. files I can grope !
  98.  
  99. - How do I know which version I have ?
  100. Look at the version strings embedded in the various source files, and into
  101. the program itself. The highest one is the winner (usually the one from 
  102. main.c).
  103.  
  104. - What's going to happen next ?
  105. <from v 3.19>
  106. Porting tracker back to the amiga was very insightful. Even though I didn't
  107. have to change the source much, I now have lots of ideas about things to add
  108. and change throughout the whole source. The next version will probably be
  109. sturdier, easier to modify, and it will probably possible to hook a real
  110. graphic interface somewhere. Also, I intend to implement better recognition
  111. of various variants of the tracker format at some point, and even MED support
  112. maybe. There will probably be some interface to sox in the near future, plus
  113. some sturdier tools to read modules, extract samples from them, and compress
  114. them better (using gzip/lha/zip to compress the module part, and shorten
  115. for the samples part).
  116.  
  117. Well, the code IS sturdier and easier to modify now, and the amiga version
  118. features a fully graphic user interface. I don't intend to add an X window
  119. interface to the unix version in the near future as I don't have the time.
  120. However, all the hooks are there, so if you want to do it, go ahead.
  121. Recognition of Med format files still turns out to be a rather nasty problem,
  122. especially since there are so many incompatible MED formats, and so little
  123. documentation. Tikkunen is a good programmer, but a poor doc writer...
  124.  
  125.     Marc Espie
  126.